Other initialization properties
This section describes properties that are related to starting objects.
HideOnInit
This LOGICAL property is defined for all visual objects and has a default value of FALSE. If your initialization code sets it to TRUE for an object before the object is initialized, then that object is initially hidden when it is created. This is an example of a property you can set from a local version of createobjects, after the objects on a page have been created but before their initializeObject code is run.
If you set HideOnInit for an object, then you must run viewObject when you want it to appear.
DisableOnInit
This LOGICAL property is defined for all visual objects and has a default value of FALSE. If your initialization code sets it to TRUE for an object before the object is initialized, then that object is initially disabled when it is created. This is another example of a property that you can set from a local version of createobjects, after the objects on a page have been created but before their initializeObject code is run.
If you set DisableOnInit for an object ,then you must run enableObject when you want it to appear.
ObjectInitialized
This LOGICAL property is set to TRUE when the object’s initializeObject procedure has been run. You should not set it yourself, but you can check its value to determine whether an object has already been initialized, to avoid running custom initialization code a second time, for example.
OpenOnInit
This LOGICAL property is defined for data objects whose QueryObject property is TRUE and has a default value of TRUE. If you set the value to FALSE before the object is initialized, then its query does not open and its temp-table is not populated. If you want the user to enter filter data to reduce the size of the dataset before any rows are returned, you can set the OpenOnInit property to FALSE. In this case the application does not needlessly open the query, populate the temp-table, and return the table to the client simply to display the first rows in the table, which the user might not want to see. This is another property that you can set in a local createobjects.
FolderWindowToLaunch
This CHARACTER property is defined for dynamic browsers. When you define a dynamic browser you can use FolderWindowToLaunch to specify the maintenance window to launch when the user selects a row in the browser. Note that the Folder Window To Launch property does not actually have to be a window with a folder in it. It does need to be a window that expects to receive a key value from the calling window, so that the child window can display the data for that row.
Figure 5–3 shows the AppBuilder property sheet for the dynamic browser, where you can set this property.
Your code could also programmatically set this property value at run time if the child window to launch depends on some application particulars.